home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / IL.z / IL
Text File  |  1998-10-30  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4. IIIILLLL((((1111))))                                                                    IIIILLLL((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      IIIILLLL - configuring the ImageVision Library runtime environment
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      The ImageVision Library (IL) is an object-oriented, extensible toolkit
  13.      for creating, processing, and displaying images. It is used by a number
  14.      of tools bundled with IRIX, including:
  15.  
  16.  
  17.           iiiimmmmggggccccooooppppyyyy
  18.           iiiimmmmggggiiiinnnnffffoooo
  19.           iiiimmmmggggffffoooorrrrmmmmaaaattttssss
  20.           iiiimmmmggggvvvviiiieeeewwww
  21.  
  22.      and some of the other desktop tools.
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      A set of environment variables can be used to configure the global IL
  26.      environment. In particular, the file format, multi-processing, graphics
  27.      hardware acceleration, caching capabilities and monitoring functions of
  28.      the IL can be controlled using these variables.  The environment
  29.      variables are summarized in a table here and describe in more detail
  30.      below:
  31.  
  32.                    Variable                Default
  33.                    ____________________________________________
  34.                    IL_ARENA_MAXUSERS       40
  35.                    IL_CACHE_FRACTION       .3
  36.                    IL_CACHE_SIZE           use cache fraction
  37.                    IL_COMPUTE_THREADS      number of processors
  38.                    IL_HW_ACCELERATE        on
  39.                    IL_HW_DISPLAY           default X Display
  40.                    IL_MONITOR_CACHE        off
  41.                    IL_MONITOR_COMPACTION   off
  42.                    IL_MONITOR_LOCKS        off
  43.                    IL_MONITOR_RESET        off
  44.                    IL_MONITOR              off
  45.                    IL_MP_ARENA_SIZE        2Meg
  46.                    IL_MP_LOCKS             on
  47.                    IL_NUM_PBUFFERS         1
  48.                    IL_READ_THREADS         1
  49.  
  50.    FFFFiiiilllleeee FFFFoooorrrrmmmmaaaattttssss
  51.      The image file formats recognized by IL are determined at runtime by
  52.      searching for dynamic shared objects (DSOs) that contain the code for
  53.      various file formats.  Refer to IFL(1) for more details on controlling
  54.      this feature.
  55.  
  56.  
  57.    MMMMuuuullllttttiiii----TTTThhhhrrrreeeeaaaaddddiiiinnnngggg CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
  58.      The environment variables IIIILLLL____CCCCOOOOMMMMPPPPUUUUTTTTEEEE____TTTTHHHHRRRREEEEAAAADDDDSSSS and IIIILLLL____RRRREEEEAAAADDDD____TTTTHHHHRRRREEEEAAAADDDDSSSS can be
  59.      used to override the default values for the number of compute threads,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIILLLL((((1111))))                                                                    IIIILLLL((((1111))))
  71.  
  72.  
  73.  
  74.      and the number of file read threads.  By default one compute thread is
  75.      created for each processor on the host system (including the user's
  76.      thread), and one read thread is created to perform disk I/O in the
  77.      background.  For example, you can disable the all multi-processing
  78.      feature in IL by issuing the commands:
  79.  
  80.               setenv IL_COMPUTE_THREADS 0
  81.               setenv IL_READ_THREADS 0
  82.  
  83.  
  84.      prior to running an IL based application.
  85.  
  86.      The size of the arena used to allocate spin-locks and semaphores for MP
  87.      control can be set with the IIIILLLL____MMMMPPPP____AAAARRRREEEENNNNAAAA____SSSSIIIIZZZZEEEE. This may be necessary if
  88.      you create a large number of objects derived from ilLink.
  89.  
  90.      The use of spin-locks to prevent concurrent access to the IL data
  91.      structures can be turned of by setting IIIILLLL____MMMMPPPP____LLLLOOOOCCCCKKKKSSSS to 0.  You can only
  92.      take advantage of this optimization if the number of compute threads and
  93.      read threads are both set to zero, and you don't make any concurrent
  94.      calls to IL from your application.
  95.  
  96.      By default the IL allows up to forty threads to be sharing the MP arenas.
  97.      If you need more, you can set the IIIILLLL____AAAARRRREEEENNNNAAAA____MMMMAAAAXXXXUUUUSSSSEEEERRRRSSSS environment variable
  98.      to a larger value.
  99.  
  100.  
  101.    HHHHaaaarrrrddddwwwwaaaarrrreeee----AAAAcccccccceeeelllleeeerrrraaaattttiiiioooonnnn CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
  102.      The environment variable IIIILLLL____HHHHWWWW____AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTEEEE can be used to override the
  103.      default behavior of using the graphics hardware to perform processing
  104.      whenever possible.  For example, you can disable the hardware
  105.      acceleration feature of IL by issuing the command:
  106.  
  107.               setenv IL_HW_ACCELERATE 0
  108.  
  109.  
  110.      prior to running an IL based application.  See the iiiillllHHHHwwwwSSSSeeeettttGGGGlllloooobbbbaaaallllEEEEnnnnaaaabbbblllleeee()
  111.      man page for possible value of this variable.
  112.  
  113.      The IIIILLLL____HHHHWWWW____DDDDIIIISSSSPPPPLLLLAAAAYYYY environment variable controls the display to be used
  114.      for accelerated operations that don't end up in a displayed window (like
  115.      statistical operations).  This environment variable uses the same format
  116.      as the X DDDDIIIISSSSPPPPLLLLAAAAYYYY environment variable.  The default value for this
  117.      variable is the current value of the DDDDIIIISSSSPPPPLLLLAAAAYYYY variable.
  118.  
  119.      The number of p-buffers (off screen framebuffer memory) that are
  120.      allocated is controlled by the IIIILLLL____NNNNUUUUMMMM____PPPPBBBBUUUUFFFFFFFFEEEERRRRSSSS environment variable.  The
  121.      default value is one on machines that support p-buffrers.  This can also
  122.      be controlled by the iiiillllSSSSeeeettttNNNNuuuummmmPPPPBBBBuuuuffffffffeeeerrrrssss(3) global function.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIILLLL((((1111))))                                                                    IIIILLLL((((1111))))
  137.  
  138.  
  139.  
  140.    CCCCaaaacccchhhhiiiinnnngggg CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
  141.      The environment variable IIIILLLL____CCCCAAAACCCCHHHHEEEE____FFFFRRRRAAAACCCCTTTTIIIIOOOONNNN can be used to override the
  142.      default size of the IL image data cache (30% of available user memory).
  143.      For example, you could set the cache size to 20% of available user memory
  144.      by issuing the command:
  145.  
  146.               setenv IL_CACHE_FRACTION .2
  147.  
  148.  
  149.      prior to running an IL based application.  Alternatively, the environment
  150.      variable IIIILLLL____CCCCAAAACCCCHHHHEEEE____SSSSIIIIZZZZEEEE can be used to set the size of the cache in bytes.
  151.      For example, you could set the cache size to 4 million bytes by issuing
  152.      the command:
  153.  
  154.               setenv IL_CACHE_SIZE 4000000
  155.  
  156.  
  157.      prior to running an IL based application.  The IIIILLLL____CCCCAAAACCCCHHHHEEEE____SSSSIIIIZZZZEEEE variable
  158.      takes precedence over IIIILLLL____CCCCAAAACCCCHHHHEEEE____FFFFRRRRAAAACCCCTTTTIIIIOOOONNNN if both are set.
  159.  
  160.  
  161.    MMMMoooonnnniiiittttoooorrrriiiinnnngggg CCCCoooonnnnttttrrrroooollll
  162.      You can use the IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR environment variable to turn on the IL
  163.      Monitor.  See the IIIILLLLmmmmoooonnnniiiittttoooorrrr(1) man page for more details.  If a less
  164.      complete level of monitoring is needed (or you need to capture a log of
  165.      the operations you can use any or all of IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____CCCCAAAACCCCHHHHEEEE,
  166.      IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____CCCCOOOOMMMMPPPPAAAACCCCTTTTIIIIOOOONNNN, IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____RRRREEEESSSSEEEETTTT and IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____LLLLOOOOCCCCKKKKSSSS.  See
  167.      iiiillllCCCCaaaacccchhhheeeeIIIImmmmgggg(3il) method, enableGlobalPagingCallback, for more information
  168.      on IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____CCCCAAAACCCCHHHHEEEE.  See iiiillllLLLLiiiinnnnkkkk(3il) method, enableResetCallback, for
  169.      more information on IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____RRRREEEESSSSEEEETTTT.  You can set IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____CCCCOOOOMMMMPPPPAAAACCCCTTTTIIIIOOOONNNN
  170.      to 1 to get a printed message each time the cache is compacted.
  171.  
  172.      If you set the environment variable IIIILLLL____MMMMOOOONNNNIIIITTTTOOOORRRR____LLLLOOOOCCCCKKKKSSSS to 1, a log of lock
  173.      creations and destructions is printed.  Additionally, at program exit,
  174.      any remaining locks are displayed.  For creations, a short message is
  175.      printed with the name of the lock.  The name consists of the address of
  176.      the lock optionally followed by a parenthetical comment describing what
  177.      the lock is used for.  For destructions and at exit time, the name of the
  178.      lock and its metering information are displayed.  The metering
  179.      information measures how many attempts were made to acquire the lock, how
  180.      many of those attempts were successful, how many times the software was
  181.      forced to start spinning on the lock, etc.  See the uuuussssccccttttlllllllloooocccckkkk(3P) manual
  182.      page for more information on the meaning of the metering information.
  183.  
  184. FFFFIIIILLLLEEEESSSS
  185.      /usr/lib/libil.so      Base (C++) library
  186.      /usr/lib/libcil.so     C API wrapper library
  187.      /usr/lib/libilMon.so   IL monitor
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIILLLL((((1111))))                                                                    IIIILLLL((((1111))))
  203.  
  204.  
  205.  
  206. SEE ALSO
  207.      IFL(1), IL(3), imgformats(1), imginfo(1)
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.